summaryrefslogtreecommitdiffstats
path: root/glucometerutils/common.py
blob: 8a36d31cbb2dedf49bbd107ccfd34853af77d2f8 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# -*- coding: utf-8 -*-
"""Common routines for data in glucometers."""

__author__ = 'Diego Elio Pettenò'
__email__ = 'flameeyes@flameeyes.eu'
__copyright__ = 'Copyright © 2013, Diego Elio Pettenò'
__license__ = 'MIT'

# Constants for units
UNIT_MGDL = 'mg/dL'
UNIT_MMOLL = 'mmol/L'

VALID_UNITS = [UNIT_MGDL, UNIT_MMOLL]

# Constants for date format
DATETIME_12HR = '12 hours'
DATETIME_24HR = '24 hours'

from glucometerutils import exceptions


def convert_glucose_unit(value, from_unit, to_unit=None):
  """Convert the given value of glucose level between units.

  Args:
    value: The value of glucose in the current unit
    from_unit: The unit value is currently expressed in
    to_unit: The unit to conver the value to: the other if empty.

  Returns:
    The converted representation of the blood glucose level.

  Raises:
    exceptions.InvalidGlucoseUnit: If the parameters are incorrect.
  """
  if from_unit not in VALID_UNITS:
    raise exceptions.InvalidGlucoseUnit(from_unit)

  if from_unit == to_unit:
    return value

  if to_unit is not None:
    if to_unit not in VALID_UNITS:
      raise exceptions.InvalidGlucoseUnit(to_unit)

  if from_unit is UNIT_MGDL:
    return round(value / 18.0, 2)
  else:
    return round(value * 18.0, 0)


class Reading(object):
  def __init__(self, timestamp, value, unit, meal='', comment=''):
    """Constructor for the reading object.

    Args:
      timestamp: (datetime) Timestamp of the reading as reported by the meter.
      value: (float) Value of the reading in the selected unit.
      unit: (UNIT_MGDL|UNIT_MMOLL) The unit for the reported reading.
      meal: (string) Meal-relativeness as reported by the reader, if any.
      comment: (string) Comment reported by the reader, if any.
    """
    self.timestamp = timestamp
    self.value = value
    self.unit = unit
    self.meal = meal
    self.comment = comment

  def get_value_as(self, to_unit):
    """Returns the reading value as the given unit.

    Args:
      to_unit: either UNIT_MGDL or UNIT_MMOLL as wanted; if None, the
      value as recorded will be returned.
    """
    if to_unit is None:
      return self.value

    return convert_glucose_unit(self.value, self.unit, to_unit)